home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 26.zip / BS1 part 26 / The Director Toolkit v1.0.adf / CLI_Commands / MakePal / docs < prev    next >
Text File  |  1987-02-25  |  4KB  |  106 lines
  1.  
  2.  
  3. |c7|t1|f2MakePal - Palette Optimizer|c3|t0|f1|r1
  4.  
  5.  
  6. |c7MakePal|c3 is a program you run from the |c7CLI|c3 that will take 
  7. one or more
  8. |c7IFF|c3 image files, and attempt to select a best-fit palette of a number
  9. of colors specified by you that can be used as a common palette or a
  10. reduced palette.|r1
  11. |e
  12.  
  13. There are a number of possible uses for |c7MakePal|c3|-.  For example, 
  14. you can take several |c7HAM|c3 images and run |c7MakePal|c3 on them 
  15. to produce a |c732|c3 color or |c764|c3 color |c7halfbright|c3 palette 
  16. that can be used as a common palette
  17. for all of the |c7HAM|c3 images.  Many Director effects are optimal 
  18. when the palettes of all the images involved are the same.|r1
  19.  
  20. Or, you might use |c7MakePal|c3 to pick a |c724|c3 color palette for a 
  21. single |c732|c3 color image, reducing the palette in order to free up 
  22. some colors for added effects.|r1
  23. |e
  24.  
  25. To use |c7MakePal|c3|-, read the section on |c7CLI|c3 commands in 
  26. the Description notes, and then from the |c7CLI|c3|-, type:|r1
  27.  
  28. |+8|c71> makepal -16 listfile palfile|c3|r1
  29.  
  30. Where |c7"16"|c3 is the size of the palette you wish to generate, 
  31. |c7"listfile"|c3 is 
  32. the name of a list file containing a list of the images to use in choosing
  33. a palette, and |c7"palfile"|c3 is the name of the output palette file.|r1
  34. |e
  35.  
  36. A list file is simply a text file (like a Director script file) list of
  37. file names, something like this:|r1
  38.  
  39. |+8|c7df1:pictures/house|r1
  40. |+8df1:pictures/figure|r1
  41. |+8df1:pictures/illus1|c3|r1
  42.  
  43. Use |c7ED|c3 or your favorite text editor to create the list file.|r1
  44. |e
  45.  
  46. If you want to make a |c7halfbright|c3 palette, use |c764|c3 as the 
  47. size of the palette:|r1
  48.  
  49. |+8|c71> makepal -64 ram:list ram:pal|c7|r1
  50.  
  51. When |c7MakePal|c3 runs, it will display each file in turn, and scan 
  52. across the
  53. image examining all the pixels.  After the last file is scanned, 
  54. |c7MakePal|c3
  55. will exit and output a coded dump of the palette generated, and will have
  56. created the specified palette output file.  The palette output file is a
  57. single pixel brush file with included palette.  You can load this into
  58. |c7DPaint II|c3 and use the |c7"Use Brush Palette"|c3 option, or load it 
  59. into |c7PixMate|c3 or |c7Digi-View|c3 with a |c7"Load Palette"|c3|-.|r1
  60. |e
  61.  
  62. |c7MakePal|c3 is particularly useful with |c7Digi-View|c3|-.  You can 
  63. actually decide to save the images when digitized in both |c7HAM|c3 
  64. and |c7RGB|c3 modes, run several |c7HAM|c3
  65. images through |c7MakePal|c3 generating a |c764|c3 or |c732|c3 color 
  66. palette, and then return 
  67. to |c7Digi-View|c3|-, load the new palette, select |c7"Freeze Palette"|c3
  68. in the palette 
  69. menu, and load each of the |c7RGB|c3 images in turn and display with the 
  70. desired 
  71. number of colors.  By then saving these images out you will have a series
  72. of images with a common palette.  The |c732|c3 color images used in the 
  73. Wipe demo
  74. were produced in this manner, using only |c72|c3 of them to pick the 
  75. best palette
  76. between the two favored images, and forcing the rest of the images to use
  77. the resulting palette.|r1
  78. |e
  79.  
  80. |c7MakePal|c3 works by building a histogram of all the pixels of all 
  81. the images
  82. and picking an optimum palette from all of them.  |c7MakePal|c3 will 
  83. then work
  84. with varying amounts of success, depending on several factors.  Generally,
  85. the more images you run through |c7MakePal|c3|-, the less effective 
  86. the resultant
  87. palette will be for any given image, even if it results in ostensibly the 
  88. |c7"best"|c3 fit palette over the entire set of images.  As previously 
  89. indicated,
  90. sometimes doing a palette pick over only a few images (usually the ones 
  91. you want to look best) and then simply forcing any other images to 
  92. use that palette can be an effective technique.|r1
  93. |e
  94.  
  95. |c7MakePal|c3 may not always produce useful results, you can generally count
  96. on the palette for any particular image to be at least a little less 
  97. optimum than the original palette for the image, and when converting
  98. |c7HAM|c3 to |c732|c3 or fewer colors, this too can lessen the quality 
  99. of the resulting image.  You will have to experiment with it and see 
  100. just how it may be useful.|r1
  101.  
  102. DPaint II is a trademark of Electronic Arts.|r1
  103. Digi-View is a trademark of NewTek.|r1
  104. PixMate is a trademark of Progressive Peripherals and Software, Inc. |r1
  105.  
  106.